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This version ot Chap 4 results from; 

1, A new PacKet format from the Port and Protocol Task Force, 

2, Host port Id is now 32 bits. 

3, Device class for the controller is Dv.msc for mass storage 
controller. 

4, Minor revisions to the characteristics and status block 
formats, 

5, Reserved fields must be zero. 



An outstanding issue is the method to be used by a host to determine 
actual unit numbers since the controller characteristics includes only 
the number of units of each class. 

The maintenance of this document will now be handled oy Bill Grace, 

Your contments will be appreciated by Bill, 

Hob ^^Itcnell 
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PRPLIMINARY HSC50 HOST INTERFACE SPECIFICATION 

Version 0.9 
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4.1 INTRODUCIION, 



4.1,1 Scope, 

This chapter defines tne interface between the host computer and the 
HSC50 Controller, 

Section 4,2 defines the general functional responsibilities which the 
Host and the Controller respectively have, 

section 4,3 specifies the constraints on the physical I/O interface py 

which the Host connects to the Controller. 

Section 4,4 specifies the overall geometry of the information on the 
disjc and the performance characteristics of the Controller as seen by 
the host. 

Section 4,5 defines the mechanisms (protocol) by which control 
Inforiration Is passed between the Host and Controller, 

MOTei 

This specification Is predicated and built upon four related documents. 
An understandlna of the contents of these documents is recommended to 
the appreciation of this document. 

UCP. (DEVICE CONTROL PACKETS); A PROPOSED STANDARD FOR MASS 
STORAGE DEVICES, R, Supniic, Revision 2, l-Oct-78 

VAX-11 PORT ARCHITECTURE, w, strecicer. Revision 2, 22-sep-78 

DEC STD XXX, STANDARD FOR INTELLIGENT DISK BAD BLOCK 
REPLACEMENT, B, Rublnson, (In preparation, herein referred 
to as DEC Std 166) 

ICCS BUS PROTOCOL, PRELIMINARY SPECIFICATION, w, Strecher, 
26-Dec-78 



4,1.2 Terminoloqy. 
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4,1,2,1 Bus and Architecture Terminology - 

1, "Subsystem" -- tne subsystem Is composed of the controller and 
all peripheral devices attached to and accessed through that 
controller. 

2, "Controller" -- the controller is the hardware and software 
which communicates with the host via DCP and causes the 
coTfpanded activity to occur on a unit, 

i. "Device Classes" — devices in the same device class share 
common functional characteristics. They transfer data in the 
same manner, are accessed similarly, ang differ essentially 
only in their access times, transfer rates, geometries, and 
error characteristics. There are two classes of devices that 
are of concern to this chapter: 

1. "Disk Class Devices" — any random access, block 
replaceable mass storage device containing data of fixed 
length blocks. This class includes rotating disks, 

PecLapes, Iu5S&, uuDuies, CCus, etc, 

2. "Tape Class Devices" -- any seguential access, variable 

length recorri mass storage device. The data on these 
devices typically cannot be selectively overwritten. 
Devices in this class include magtapes and TU60 cassettes, 

4, "Class Driver" — the code in the host operating system that 
controls the operation of a peripheral or set of peripherals of 
the same class. It typically serves to interface the 
device-independent logical I/O system to the peculiarities of a 
particular device or class of devices. It is at the device or 
Class driver level that the interface described in this chapter 
will be implemented in most host operating systems, 

5, "Port Driver" — the code in the host operating system that 
manages the operation of an i/o bus port. It typically serves 
to interface the totally command-delivery-mechanism independent 
device or class driver to the peculiarities of a particular bus 
or device co'i^mand delivery mechanism. 

6, "Unit" — as used in this document, a unit Is any distinct, 
addressable component in the subsystem tnat serves a logically 
distinct function from other components in the subsystem. 
Typicallv they represent Individual disk drives, tape drives, 
or Individual disks in multi-unit drives, but the controller 
Itself is a loylcdl unit as well. It is to logical units that 
individual commands are directed. 
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4.1,2.2 OisK Format Terif Inology. - 

1, "Block"-- On disK Class devices* a block corresponds to a 
sinqle, addressable data region of 512 or 576 bytes in length 
(depending on format). For this class of devices, all blocks 
are of the same length. 

On tape class devices, a block corresponds to a single data 
record on the tape. For this class of devices, a block may be 
of any length, 

2, "Logical Block Number (LBN)"-- A number which identifies a 
particular data block's relative position in the total set of 
blocks made available to the host on a particular unit of a 
particular device. Each unit presents to the host a set of 
logically contlgous blocks numbered from to n-1, where n is 
the total number of blocks available on the unit. This number 
bears no necessary relationship to any Physical placement of 
that block on the unit itself; L8n to physical address 
translation is a function of the controller alone. The number 
ot Dlocks per cylinder is a characteristic of d unit, 

3, "Replacement Block wumber"-- A number which identifies the 
block on tne disk tor Placing a block of data when the original 
disk block location is bad. The block is still accessed by 
referencing the LBN, The replacement block number Is assigned 
by the HSC50 when a write with replacement command is given. 
The host must specify the RBN for the UDA50, 

4, "DEC STD 166"— A proposed replacement for dec STO i44. It 
provides substantially more information than the current 
standard, and Is necessary to accomodate substantial changes In 
disk format induced by new technologies. Specifically, it 
Includes information describing the parameters of disk format, 
a bad block map, and a replacement block map that is 
considerably larger than existing versions. 



4.1.2.3 Tape Format Terminology - 
\To be speclfied\ 

4.1.2.4 Control Protocol Terminology, - 

1, "Packet"-- A pacKet is a single, discrete, self-contained 
control message transmitted between the nost and controller via 
an undefined messaae delivery mechanism. Packets transmitted 
from the host to the controller convey command information to 
the controller, PacKets transmitted between the controller and 
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host convey status and operation result Information to the 
host. 

2 "Hard Initialization"""- The restarting ot the controller as if 
the controller is being powered up for the first time. All 
context from previous operation is lost. Hard initialization 
results from physical conditions in the controller (power up, 
component failure) or from a bus-level action by a host, 

3, "Soft Initialization"— The resetting and resynchronlzatlon of 
the controller relative to a particular host. The controller 
continues running and context not Involved with the 
initializing host is retained, but operations relative to the 
Iritializlnq host Itself are aborted and eowmunlcatlon with the 
host is resynchronized. Soft initialization results from a 
command by a host. Soft initialization is required because 
hard initialization cannot be used to resynchronize In a 
multi-host environment, 

4, "Characteristics"" Characteristics are those controller or 
unit parameters which govern operation of the controller or 
unit, affect the interpretation of and action on commands, and 
Change relatively inf reguently. Examples of characteristics 

are shadowing relationships, controller error thresholds, and 
tape unit density and speed settings. 

5, "Status"— Status is the set of variable physical conditions 
describing the current physical and logical state of the 
controller or unit. Status can change relatively frequently. 
Examples of status are the online/offline logical state of a 
unit, error flags, and the physical state of the spindle and 
panel switches, 

6, "Host Timer" and "Command Timer"— Logical timers used to 
detect DosslDle failure of the host or controller. The "host 
timer" is a timer set by the controller to monitor activity on 
the part of the host and detect failure to utilize the logical 
connection to the controller over an extended period of time. 
The "command timer" Is a timer maintained by the host to 
monitor controller activity and detect controller failure to 
complete a command in an acceptable time frame. 

7, "Controller offline" and "Controller Online" -- Logical states 
of the subsystem relative to the host. The subsystem may be In 
either of these two states relative to each host to *hich It is 
Physically connected, and may be in different states to 
different hosts. The logical state that a controller is in 
governs the set ot commands It will process and actions It will 
take on benalf of the nost. 



8. 



"Unit Offline", "Unit Available", and "Unit Online" -- Logical 
states of a particular subsystem unit relative to the host. 
Depending on the logical state of the subsystem relative to the 
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host, individual units attached to that suttsystem may also be 
in one of three logical states relative to a host. The logical 
state of a unit governs whether or not it is available to 
process requests on benalf of the host, 

9, "Shadowing"-- The duplication of a mass storage transaction on 
two units of the same device class. A shadowed unit Is 
typically an image of another unit? it contains no history 
describing the steps by which the image *as arrived at. 
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4,2 HOST & CONTROLLER FUNCTIONAL RESPONSIBILITIES 



4,2,1 Responsibilities of Controller 



4,2,1,1 Minimum Integrity Diagnosis - 

The controller is responsible for executing sufficient diagnostics 
locally to establish minlmuro ooerational and communication intearity 
each time the controller is powered up or hard initialized. Among the 
elements which must be tested are the controller processor. Internal 
busses, internal memory, load device (TUgB), and comffiunication port to 
the outside world. 

It is also the controller's responsibility to avoid signalling to the 
nost tnat it is dvaiiaoie to cotne online unless tnese Diagnostics have 
been successfully executed. 



4,2,1,2 Notification of Controller Status Changes - 

The controller is responsible for raaicing available to a connected host 
notification of all spontaneous changes In controller status other than 
tnose resulting in controller failure, status changes include changes 
in the availability or physical state of any of the units attached to 
the controller, non-fatal changes in the configuration or state of the 
controller itself, or any spontaneous Initializations that occur in 
controller or drives. 

The set of possible status changes that can take place in the subsystem 
will be divided into classes ranging from the most serious (controller 
spontaneous reinitialization) to the commonplace (drive changes such as 
write protect, pacic unloaded, etc). The controller is responsible for 
providing the nost with a mechanism for directing which classes of 
status chanoes are to be reported and which are not. In addition to the 
Class of error setting for each host ,the controller will provide for 
each host to specify receipt of either error log Information which is 
controller spontaneous, or controller spontaneous and those related to 
that host's commands, or controller spontaneous and those related to all 
hosts. 

The controller is responslDie tor notifying all hosts described in its 
internal configuration data base of its hard reinitialization. 
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4,2,1,3 Notification of Errors - 

The controller is responsible for notifying the host when a command 
cannot be successfully completed, and for supplying information 
regarding the exact nature of the error a$ part of that notification. 

The controller is responsible for making available to the host 
appropriate information for the host error log whenever a command cannot 
be successfully completed or whenever a command is successfully 
completed, but the successful completion of the command required the use 
of an error recovery procedure in the subsystem. 

The set of possible error log situations will oe divided into classes 
ranging from the serious (drive mis-seelc, ECC error involving large 
number of symbols) to the commonplace (single-symbol ECC error, physical 
bad blocK), The controller Is responsible for providing the host with a 
mechanism for directing which classes of error log Information are to be 
reported and which are not. 



4.2.1,4 Command Integrity Verification - 

The controller Is responsible for verifying the Integrity 
(opcode/parameter validity, etc.) of each request that it receives from 
the host, and for rejecting those commands that are not valid in the 
current subsystem context (as determined by the controller parameter 
base and state, i,e, current CHARACTERISTICS and STATUS), 

The controller will execute each valid command, and has NO 
responsibility relative to the validity of a series of commands. 



4,2,1.5 Verification of Host Connection Before Relinquishing Drive - 

If a dual-ported drive 'online' to a controller requests verification of 
the drive-to-controller connection, the subsystem is responsible for 
verifying that It Is still 'controller online' to at least one host 
before retaining its connection to the drive, A controller must not 
keep a dual-ported drive online if all hosts to which it can be 
logically connected are 'controller offline'. 



4,2,1,6 Shadowlna Responsloillties - 

The controller is responsible for duplicating all *rlte operations to a 

Shadowed unit on the appropriate shadow unit, and for avoiding 

notification of successful completion of the initial operation unless 

and until both tne Initial operation and the duplicate are successfully 
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coniDleted. 

If a physical status change occurs for reasons other than host command, 
such as FE initiated pacK spin do*'n, the host will oe notified on the 
next host reference to either unit or by an ATTENTION message, depending 
on the situation. 



4,2,1,7 Guarantee of FIFO Data Integrity on Disk Class Devices - 

The controller is responsible for satisfying all write operations of the 
same priority class to a particular LBN on a particular disk-class unit 
such that all operations of the same priority class on that LBH that 
preceeded it are completed before the wRiTE is processed, and any 
operations of the same priority class to the same LBN that follow it are 
postponed until the *(R1TE is completed. 

Note that this responsibilltlity Is within request priority classes 
only; the controller has no responsibility to satisfy requests of 

Jiffering orioriLy to Lne same Lfa.i In any particular order, regardless 
of tne fact that they may Include conflicting reads and writes. 

The controller is M)T resoonsiole for satisfying reguests to different 
LBNs on the same disk-class unit In any particular order, or for 
satisfying read operations in any particular order. 



4,2,1,8 Guarantee of Serial Command Execution on Tape Class Devices - 

The controller is responsioie for executing all operations on tape class 
units serially in the order In which they are received. 



4,2,1,9 Timeout of Requests tor Host Data - 

The controller is responsible for timeout of each request for host data 

(for WRITE or COMPARE) sent to the host, and for suitable error recovery 

(to be defined) should that timeout actually occur. 



4,2,1,10 Change to write-PROTECI Status - 

If the controller can determine that a host is not operating correctly, 
the controller is responsible for changing its status relative to that 
host to wRITE-PROTECl. Normal operation can be reestablished by the 
host resynchronizina with the controller. 
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The criteria that the controller will use to establish that a host is 
disabled are enumerated in Section 4,5,2,1,2,1 



4,2,1,11 Formatting and Reformatting - 

The foripattlng and reformatting of units is the responsibility of the 
controller via software executing in the controller itself. Formatting 
and reformatting operations are initiated in the controller via the 
appropriate host or FE panel command. 



4,2,1,12 Automatic Revectorlno of Bad Blocks - 

The controller Is responsible for automatically revectorlng bad blocks 
when formatting a volume and when copying one volume to another. An 

unrevectoreo udti block on tne source unit *iii oe copied cjnd tne aata 
marked invalid on the copy. 



4,2,1,13 Maintenance of DEC STD 166 Information - 

The controller is responslblle for maintenance of and utilization of the 
information In the 166 area for the purpose of revectorlng bad blocks. 

The controller is also responsible for denying the host write access to 
the 166 area. 

The host can utilize the information in the 166 area as appropriate to 
Its particular needs. For example, the host can use the bad block and 
replacement block Information in the 166 area as part of Its file 
allocation policy if that policy requires such information. 

The host accesses the 166 area directly via that portion of the LBN 
space assigned to that purpose on each unit. 



4,2,2 Responsibilities of Host 
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4,2,2,1 Minimum Interface Integrity Diagnosis - 

The host is responsioie for diagnosing the physical interface between 
itself and the controller. The host is responsible for executina this 
diagnostic before attemotinq to use the logical connection with the 
controller. 



4.2.2,2 Resynchronizing with the Controller - 

The host is responsible for resynchronizing with the controller under 
the following circumstances j 

1, The host itself is powered up or reinitialized, 

2. The host is recovering from possible controller failure. 



4,2,2,3 Integrity of Commands - 

The host is responsible for sendlncr only syntactically and semantlcally 
valid commands to tne controller. Furthermore, the host is responsible 
for the relationships between commandsr the host must not issue 
commands that conflict with each other or with commands from another 
host connected to the controller. 



4,2,2,4 Managing Controller Operation - 

As part of managing the controller operation, the host is responsible 
for determining tne current characteristics of the subsystem, and for 
changing the controller characteristics and thresholds to those 
necessary for proper operation with the connecting host. 

The subsystem will operate under a set of default characteristics and 
thresholds should the host choose not to alter them, but in this case 
the host is responsible for operating meaningfully with the default 
subsystem characteristics. 



4,2,2,5 Unique Reference Numbers - 

The host Is responsible tor supplying a unIOUF reference number In every 
command that is outstanding to the controller at any given time. 
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4, 2,2,6 Timeout of Commands - 

The host is responsiPle for ensuring that each command that is 
transmitted to the controller is covered by a timer. If more than one 
command is simultaneously outstanding to the controller, then the host 
is responsible for covering a series of commands with a gross timer or 
for managing multiple timers. If any command timer expires, the host Is 
responsible for appropriate error recovery action (defined in Section 
4,5.2,4) The host should NEVER ask the controller to perform an untimed 
operation. 



4,2,2,7 Reissue of Outstanding Commands - 

Under certain error conditions (command timeout, controller 
reinitialization due to non-critical component failure, etc.) the host 
is responsible for resynchronizing with the controller and reissuing all 
commands that were outstanding at the time the error was detected. In 
this instance, the host is also responsible for insuring that the 
cosTimarids are not reissued until tne prescribed resynchronizatlon nas 
been successfully accomplisned. Note that across resyncnronizations and 
reinitializations, the controller's set of outstanding commands are 
"erased", so tne san^e reference number can be reused. 



4,2,2.8 Error Recovery with a Falling Controller - 

If a host detects that a controller is falling, it is the host's 
responsibility to cease issuing further commands to the controller and 
to execute the error recovery sequence prescribed in Section 4,5,2,4, 

The criteria that the host is to use to determine that a controller is 
failing are enumerated in Section 4,5,2.4. 



4,2,2,9 Revectorlng of wear-caused Bad Blocks - 

When a bad Mock is reported to the host, the host is responsible for 
directing the controller to replace that t>&cii blocK with a replacement 
blocK when and if consistent with host policy. 

The controller ^-ill not replace bad blocks (unless formatting or copying 
a volume) unless directed to do so by th*» host. 
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4,2,2,10 Coordination with Other Host(s) - 

In an environiiient wnere multiple hosts are connected to the same 
controller, the hosts are responsible for coordinating their access to 
the subsystem so that there Is no conflict for the same units or data. 
The controller will satisfy any request for any unit from any host; it 
will NOT protect multiple hosts from each other. 

Furthermore, the hosts must coordinate their subsystem characteristics 
changes such that conflicting characteristics commands are not given to 
the controller. The latest set of characteristics and parameters in 
force in the controller will be the latest set received from any host; 
the controller win not detect conflicts between multiple hosts 
requestlna different characteristics or status parameters. 



4.2,2,11 Shadowing - 

it units are to De snaaowed, the nost is responsioie for directing tne 
controller which units are to oe shadowed by which units as part of the 
controller characteristics establishment. 

The host Is responsible for any shadowing at other than the unit level 
by issuing the appropriate combination of individual commands to achieve 
the desired shadow functionality. 



4,2,2,12 Error Logging - 

It is the host's responsibility to process error log Information passed 
to It from the controller in a manner consistent with host policy. 

If error log information is to be reported to the user, it is the host's 
responsibility to do so. 

The host is also responsible for determining and setting which classes 
of errors are to be reported by tne controller. 
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4,3 HOST PHYSICAL INTERCONNECT 

This specification discusses the functions that the device driver 
performs to control the operation of the controller. It is documented 
Independent of whatever physical delivery mechanism is used to wove 
command packets and data between the host and controller. The protocol 
described in this chapter assumes certain characteristics that the 
delivery mechanism must have, however* and these assumptions are 
documented in this section. Theoretically, any delivery mechanism which 
provides the necessary guarantees and functional interfaces should be 
usable with any disic or tape class driver that conforms to this 
specification. A new port driver for the new delivery mechanism should 
be all that is required. 



4.3.1 Guarantees Required of Control Packet and Data Transport Mechanism 

Ine aeiiverv " ecuanisni rriusL ue capanie of guaranteeing tne folio*ina to 
the device class driver: 

1, That tnessage packets queued to the port driver on a given 
priority level will be sent and received In the order in which 
they are queued, 

2, That transmission errors will be detected and the appropriate 
low level error recovery operations (resynch, retry, etc.) win 
automatically occur, 

3, That transn;ission errors reported by the port are not 
recoverable, 

4, That message transmission will stop when an unrecoverable error 
is detected? that is, those messages queued to the port driver 
behind the erroneous message will not be transmitted until the 
class driver has intervened. This is required in order for the 
controller to be aole to fulfill Its LBN FIFO guarantee, 

5, mat a bus-level hard initialize function exists, and when 
invoked causes an unconditional reaction on the initialized 
node that forces the initialized node to a known state and does 
not depend on functioning software in the initialized node to 
operate. 

6, Tnat a bus-level echo function exists that completes a circuit 
tnrough tne bus and receivinq node as well as tne sender, 

7, That non-acceptance of a message at a receiving port be 
recognizable at the sending port. 
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4,3,2 Functional interface to Control Packet Mechanism 

The interface bet^feen the port driver and the class driver is assumed to 
have the following functional characteristics: 

1, A message is sent to the controller oy passing to the port 
driver the address of a buffer containing the naessage and an 
indication that it is to be sent to a particular node on the 
bus (the controller). 

2, The class driver Is notified that an attempt to send a message 
was unsuccessful when the port driver passes bacK to the class 
driver the address of the buffer containing the original 
message and an indication that a transmission error has 
occurred. In this instance, further transmission *iil be 
inhibited until the class driver indicates directly that 
transmission is to resume, 

3, The class driver is notified that a message has been received 
when the port driver passes to tne class driver tne address of 
a buffer containing the message and information deflnina the 
sender. 

4, The class driver has control over whether the port is actively 
transmitting, receiving, or both (relative to the calling class 
driver only) via appropriate indications to the port driver. 

5, The class driver has control over reinitialization and 
resynchronization of the port (relative to the calling class 
driver only) via appropriate indications to the port driver. 
When told to reinitialize, the port driver discards any 
outstanding work relative to the calling class driver and 
resets to an idle, non-transmlttlng and non-receiving state for 
that class driver ready to begin the first operation Indicated 
py that class driver, 

6, The class driver has the capability of causing a bus-levei hard 
initialize of tne specified node via appropriate Indications to 
the port driver, 

7, The class driver has the ability to verify the integrity of its 
connection with a specified node by passing the address of a 
buffer to the port driver and indicating that it is to oe 
echoed via the appropriate node. The port driver •(ill return 
the address of another buffer contalnlno the echoed data when 
the echo loop has been co^npieted. 
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4,3,3 Functional Interface to Data Transfer Mechanism 

\To Be Speclfied\ 
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4,4 CONTROLLER PHYSICAL CHARACTERISTICS 



4.4.1 Geometry of Mass Storage Information 

See SDI documentcChapter 5 of HSC50 Specification) 

4.4.2 DEC STD 166 Areas 
See 166 docurrient, 

4.4.3 Controller Performance Characteristics 
See Chapter 3 of hscSO specification 
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4.5 CONTROL PROTOCOL CHSC50 Implementation of DCP - DEVICE CONTROL PROTOCOL) 



4.5,1 General Cnaracteristics of Control Protocol 



The HSCSO control protocol has the following general characteristics: 

1, The total HSC50 control interface is divided into four logical 
levels. The lower levels (0 s. i) are documented in the port 
specification. The higher levels (2 & 3) are documented in the 
following sections. The levels are: 

1, Level - the physical systcn used to transmit information 
along the bus connecting the host and controller, 

2, Level 1 - the port system by which messages and data are 

Lran&ifiilted aetween tue host and conLroiier. 

3, Level 2 • the actual control information passed between the 
host anri controller. This level contains the messages 
themselves, 

4, Level 3 • fixed sequences of level 2 commands and responses 
that are executed as a group to perform higher logical 

functions. 

2, It is a master/Slave protocol. The HSCSO is a middle element 
in the host-drive communication^ and as such is the servant of 
the host. The responsibilities in the protocol are asymmetrlCf 
allowing the host to dominate operations such as communication 
resynchronlzation, 

3, The lower levels of the protocol are symmetric. Although the 
responsibilities in the protocol are asymmetric, the mechanisms 
used to dispatch these responsibilities are identical In both 
directions. The sa.pe pacicet format is used in both directions 
(with different semantic interpretations), and symmetric 
delivery mechanisms are assumed. 
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4,5,2 General Rules Governing Control Protocol Usage 



4,5,2.1 Subsystem Logical States - 



4,5,2,1.1 Subsystem fjoglcal State Definitions - 

The subsystem may be in eitner of two logical states relative to any 
host. Note that in a iT.ulti-host environment, the subsystem logical 
state relative to a particular host Is independent o£ its state relative 
to any other host. These states arej 

1, "CnNTROLr,ER OFFLINK", The 'controller offline' state is just 
what It Implies, A subsystem that is 'contoller offline' is 
not available to the host and cannot perform any operations on 
behalf of the host. Note that there are several reasons a 
subsystem may oe 'controller ottiine' to a given host, only 
some Of wnich are inoperable hardware. The subsystem may be 
'controller offline' to the host because the host bus enable 
button on the front panel has disabled the host bus, or it may 
be 'controller offline' because the operator or FE has removed 
the controller from service (via its FE panel), 

A host can distinguish a subsystem that is in the 'controller 
offline' state because it will not respond correctly to any 

command. 

Each time the subsystem maKes the transition from the 
'controller offline' state to the 'controller online* state, it 
sends a REINITIALIZED attention message to all hosts that are 
described in the controller's Internal configuration tables. 
It will send this message regardless of whether the 
reinitialization was spontaneous or forced. After the 
REINITIALIZED message the next command from the host must be an 
INIT to assure proper synchronization of tne host and the 
controller. 

The PSUEDO TERMINAL IN command is the only command which is 
potentially recognizable by the controller in the offline state 
and then only for diagnostics, 

2, "cnNTROi.r.FR ONLINE". A subsystem that is 'controller online' 
to a host Is logically connected to that host and can execute 
its entire command repertoire on behalf of that host, 

A host can distinguish a subsystem that is in the 'controller 
online' state because it will execute all commands and the 
summary status in the END packet will indicate that the current 
subsystem state is 'controller online'. 
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Note that the logical states of the subsystem are distinct from but 
related to the logical states ot any units connected to the controller. 
If a subsystem Is 'controller offline' to a host, then all units 
connected to the controller are also 'unit offline' to the host. If a 
subsystem is 'controller online', however, then the individual units 
connected to that controller may themselves be 'unit online', 'unit 
available', or 'unit offline' to the host, independent of each other, 
depending on their states relative to the controller. All state changes 
in the subsystem (Including unit state changes) are reported to the host 
if the subsystem is 'controller online' and such Information is desired. 



4.5,2,1,2 Subsystem state Transitions - 



4,5,2.1.2,1 Controller Offline - 

The subsystem enters the 'controller offline' state relative to a 
particular host wnenever it ceases to function because of power failure, 
hardware failure, software failure, spontaneous hard reinitialization, 
or commanded hard reinitialization. In addition, the subsystem enters 
the 'controller offline' state relative to the host after sending a 
DISCONNECTING attention message because the host bus enable switch on 
the controller panel has been disabled or a command removing the 
subsystem from service was received at the FE panel. Basically, any 
condition which disables the controller or destroys Its context takes it 
into the 'controller offline' state. 



4,5,2,1,2,2 Controller Online - 

The subsystem enters the 'controller online' state relative to a 
particular host when It successfully executes the diagnostics after a 
power-up, bus level Inltallzation or being returned to service by FE 

panel command. 

The subsystem leaves the 'controller online' state relative to a 
particular host whenever the following occurs: 

1, It Is forced Into the 'controller offline' state by bus-level 
init commana, internal failure, FE command removing the 
subsystem from service, power failure or a nost ous switch 

change. 

Note that it the controller is forced down by host bus switch change, FE 
command removing It from service, or an internal condition that does not 
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Impact its integrity, it tries to leave the 'controller online' state in 
an orderly fashion. This orderly disconnect Is merely a convenience; 
the protocol is designed to function properly if orderly disconnect 
falls. See Section 4.S.2.5.2. 

There is a special situation when the controller will change its status 
to WRITE PROTECT relative to a host. This occurs when the controller is 
in the 'controller online' state and concludes that the host is 
Potentially down. The controller will conclude that the host is 
potentially down (not operating correctly) if any of the following 
occurs: 

1, Unrecoverable bus errors are repeatedly reported by the port. 

2, A reguest for host data repeatedly times out. 

3, The host does not issue a command within the host timeout 
period specified in the GET CHARACTERISTICS command. 

4, The controller receives \ to be specified numberv consecutive 

erroneous coniiiianas troni tne host. 



4,5,2.2 Unit Logical States Relative to Host(s) - 



4,5,2,2,1 Unit Logical state Definitions • 

Each individual unit may be in one of three logical states relative to 
each host. The unit logical state is a function of the subsystem 
logical state relative to the host, and the unit's logical state 
relative to the controller Itself, Units have logical states 
Independent of each other. Furthermore each unit occupies the same 
logical state relative to each host that has the same logical state 
relative to the subsystem. For example, units that are online to the 
controller are 'unit online' to ail nosts to which the subsystem is 
•controller online'. 

The unit states relative to the host arej 

I, "UNIT OFFLINE", A unit that is 'unit Offline' is one that is 
unavailable to satisfy any host requests. Units niay be 'unit 
offline' due to hardware failure, an FF command removing the 
unit from service, or an inability to come online to the 
controller (e.g.. It tnay already oe online to another subsystefT 
and is hence offline to this one). 

The subsystem will reject requests for a unit that is 'unit 
offline' to the host. Tne host can determine that a unit is 
'unit Offline' by Interrogating its status. 
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2. "UMT AVAILABLE", A unit that is 'unit available* is one that 
is available to come online to the host, but has not yet done 
so because no commands have yet been received for that unit, 
'Unit available' is a temporary state that is significant to 
the host only oecause notification of transition to this state 
often serves as a Key that operations to the unit can begin. 

The subsystem will attempt to satisfy requests to a unit that 
is 'unit available' by attempting to bring the unit online to 
the controller. The host can determine that a unit is 'unit 
available' by interrogating its status, 

3, "UNIT ONLINE", A unit that is 'unit online' to the host is one 
that is online to the controller and can execute functions on 
behalf of the host. 

The subsystem win accept and execute commands for a unit that 
is 'unit online'. The host can determine that a unit is 'unit 
online' by interrooatino its status. 



4,5,2.2.2 linlt Logical state Transitions - 



4,5,2,2,2,1 unit Offline - 

An individual unit enters the 'unit offline' state relative to the host 
whenever any of the following occurs: 

1, The subsystem leaves the 'controller online' state, 

2, The unit becomes offline to the controller; that is, the unit 
is not available for controller access. See the next chapter 
for drive states relative to the controller, 

3, Tne unit is removed from service (taken 'unit offline' from the 
host) by a command at the FE panel or by a diagnostic internal 

to the suDsystem, 

A unit leaves the 'unit offline' state whenever the subsystem is in the 
'controller online' state and any of the following occurs: 

1, The unit reinitializes and becomes avaiiaole to tne controller. 
See the next chapter for drive states relative to the 
controller. 

2. The unit is returned to service (made 'unit available' or 'unit 
online' to the host) oy a command at the FE panel or by a 
diagnostic Internal to the subsystem. 
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3, The unit's status is successfully changed to 'unit available' 
or 'unit online' by a host SET STATUS comffiand. 

A unit also leaves the 'unit offline' state whenever the subsystem 
enters the 'controller online' state andj 

1, the unit is available to the controller, in which case it 
enters the 'unit available' state, or 

2, the unit is online to the controller, in which case it enters 
the 'unit online' state. 



4,5,2,2.2,2 Unit Available - 

A unit enters the 'unit available' status relative to the host whenever 
the subsystem is 'controller online' and one of the following occursi 

1, The drive sianals Its availability to the controller, 

2, Tne drive Is in the available state relative to the controller 
and Is returned to service by FE or subsystetr -ilagnostlc 
coRimand, 

A unit also enters the 'unit available' state when the subsystem enters 
the 'controller online' state and the drive is in the available state 
relative to the controller, 

A unit leaves the 'unit available' state whenever one of the following 
occurs » 

1, The subsystem leaves the 'controller online' state, 

2, The subsystem receives a command for the unit and brings the 
unit online to the controller, 

3, The host changes the unit status to 'unit online' via a set 
STATUS command. 



4,5,2.2,2,3 Unit Online - 

An individual unit becotnes 'unit online' to the host whenever the 
subsystem is in the 'controller online' state and one of tne following 
occurs: 

1, The controller receives a valid command for a 'unit available' 
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unit and succeeds in bringing that unit online to the 
controller, 

2. The unit is returned to service (placed 'unit online' to the 
host) by a command at the FE panel or by a diagnostic internal 
to the subsystem, 

3, The unit's status is successfully changed to 'unit online' by a 
host SET STATUS command, 

A unit also enters the 'unit online' state whenever the subsystem enters 
the 'controller online' state and the unit is online to the controller. 

An individual unit leaves the 'unit online' state relative to the host 
Whenever one of the following occurs: 

1, The subsystem leaves the 'controller online' state, 

2, The drive leaves the online state relative to the controller, 

Gee next cnapter, 

3, The unit is removed from service by an FE command or by a 
rtiaqnostlc Internal to the subsystem, 

4, The unit's state is changed to 'unit available' by a host SET 
STATUS command. 
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RELATIONSHIP OF CONTROLLER AND UNIT STATES 



The states In the boxes are the unit states relative to the host: 



SubsysteiB State Relative to Host 



'Offline' 



Drive state 

Relative 'Avallaoie' 
to Controller 



'online' 



'Controller 
Offline' 



'Unit offline' 



'Unit offline' 



'Unit offline' 



'Controller ! 
Online' l 



i 

'unit offline'J 

1 



'unit available' 



1 
'Unit online' i 



In general, whenever the suosystem enters the 'controller online' state, the 

unit enters the state dictated by Its state relative to the controller. Also, a 

unit's logical state is only visible and variable when the controller is 
'online'. 
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SUBSiSTEM LOGICAL STATE TRANSITIONS RELATIVE TO A SINGLE HOST 
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UNIT LOGICAL STATE TRANSITIONS RELATIVE TO A SINGLE HOST 
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4.5.2.3 Command Flow - 

The normal flow of each command issued by the host is diagrammed below. 
Basically, the command is issued and timing for that command is started. 
The controller will interpret the command* Initiate any data transfer 
operations that are required to complete the command, and signal the 
eventual completion of the command (whether successful or not) with an 
END message. At any time a unit, including the controller, may send a 
LOG message; if the log packet is related to a particular command, it 
will contain the reference number of the command in question. If it is 
a general log message not related to any particular command, the 
reference number ^iii be 0, 

For transfers larger than one sector, the controller is liicely to divide 
that transfer into smaller sub-transfers, known internally as 
"fragments". The data for each fragment of a WRITE transfer will be 
fetched from the host via a seperate request. The order in which 
fragments are processed will depend on conditions internal to the 
subsystem and frequently will not oe In order of ascending Lsn or buffer 
address. 

Note that attention messages may also be sent at any time relating to 
any unit in the subsystem. 

Note also that the steps in this flow may not necessarily be contiguous? 
if more than one command is outstanding, message and data traffic 
relating to any or all of these commands may be Interleaved in a totally 
random fashion, 

READ COMMAND FLOW 



f 5 number of fragments necessary 

to successfully complete transfer 

Step 1 Host sends READ command packet requesting 

read of n blocks and starts timing command. 

Step 2 Controller sends data for a fragment 

to host memory via bus data transfer mechanism. 



step f+1 Controller sends data for last oustanding fragment 

to host memory via bus data transfer mechanism. 

Step f+2 Controller sends FND packet sionalllno 

completion of command and Indicating status. 
Host stops timing command. 
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wRITfc COMMAND fbOW 



f s number of fragments necessary 

to successfully comolete transfer 

Step 1 Host sends WRITE command packet requesting 

write of n blocks and starts timing command. 

step 2 Controller reguests nost port to send 

data for a fragment from host memory 
via bus data transfer mechanism. 

Step 3 Host sends data for reguested fragment 

via bus data transfer mechanism. 



step 2t+l Controller reguests host Port to send 

data for last oustanding fragment from host memory 
via PUS data transfer mecrianism. 

Step 2f+2 Host sends data for last outstanding fragment 

via bus data transfer mechanism. 

Step 2f'»-3 Controller sends End packet signalling 

completion of command and indicating status, 
Kost stops timing command. 
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4.5,2.4 Error Recovery - 

The host has only two basic error recovery procedures available to it 
for errors at Level 2 and Level 3, Level and Level 1 errors are dealt 
with by the Transport Mechanism, If a command falls because of a 
physical error, the subsystem has already taken all corrective action 
possible, and further recovery attempts by the host are useless. If a 
command Is rejected because of a logical inconsistency, the host 
corrects the problem and reissues the command. If a command fails for 
any other reason, the host must resynchronlze with or reinitialize the 
controller, and reissue all outstanding commands at the time of the 
failure. Including the failing command. Note that the details of the 
resynchronlzation and reinitialization procedures are described in the 
sections that follow. 

Particulars of these error situations follows 

1, If the controller reports that it cannot execute a valid 
cofumand for a particular reason, the host is to taice error 
recovery action appropriate to the indicated reason. For 
example, it a valid command is rejected by the controller, tne 
host snould attempt to resynchronlze with the controller. If 
the controller reports that a hard 1/0 error has occured on a 
request, the host is to assume that the controller has taken 
all corrective action possible, and is to report the error to 
the application as uncorrectable, 

2. If the command timer for any particular command expires, the 
host is to issue a GET STATUS command as a means of verifying 
the bus and connection. If this GET STATUS command is not 
successfully sent by the port, the connection to the controller 
should be assumed broken. If the GET STATUS is successfully 
sent and either succeeds or times outr the host should set a 
longer INIT timer and Issue an INIT command to the controller 
to resynchronlze and flush outstanding commands. If the INIT 
succeeds, the host is to reissue all outstanding commands^ 
incmdlnq the one that timed out originally. If the iNlT fails 
or times out, the host is to set a very long hard Init timer 
and issue a bus-level init to the controller. If the hard init 
timer also times out before a REINITITIALIZED attention message 
is received from the controller, the host Is to assume the 
controller is down and wait until the message is received (it 
always will be received eventually). If the hard init 
succeeds, the host is to reconnect to the controller and 
reissue the commands that are outstanding, including the 
original one that timed out. 

Note that tne timers that are set for the IHlT and ous-level 
Inlt operations must be \to be specifiedV and \to be specifiedN 
multiples of the standard command timer respectively, This is 
necessary to avoid race conditions caused by multiple-hosts 
issuing hard inits at close intervals. 
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A diagram of the comcnanct timeout recovery sequence Is at the 
end of this section, 

3, If the controller reports an error that could be a 
communications error (invalid command code, invalid aras, etc,) 
and the comittand appears valid to the host, the host may treat 
the error as if the offending coiflinand timed out or may try 
retransmission, depending on the reliability of the transport 
mechanism. 

4, If the host receives a communication from the controller that 
it cannot interpret (jibberish) or that is obviously out of 
context (e.g., an END for a coiomand that cannot be 
outstanding), the host should treat the error as if a command 
tlfped out. 

5, If the host is restarted, it roust resynchronize with the 
controller. 

6, it trie nost receives a REiiMlTlAijl^tU attention niessage fro-Ti tne 
controller or a command Is rejected because the subsystem has a 
WRITE-PROTECT status relative to the host, the host must 
resynchronize with the controller and reissue outstanding 

coi^mands . 
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FAILED COMMAND RECOVERY SEQUENCE 
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4.5,2,4,1 Resynchronization - 

The host is the master in tne host-controller relationship, and as such 
it is responsible for synchronization with the controller. Whenever 
there is a question as to the state of either party across the 
interface, the host must resynchronize as described below. The 
controller's responsibility is limited to notifying the host of the need 
for resynchronlzation. 

Note: the synchronization described here Is for the highest levels of 
the protocol only. Any resynchronlzation at lower levels is independent 
of this level and Is the responsibility of the port and port drivers. 
The levels described here assume an already synchronized transport 
mechanism. 

Note that resynchronlzation will not always succeed in restoring a 
malf unctionlnq controller to a fully operational state. It will succeed 
much of the time, however, and it is recoaiwended because it is much 
faster that hard reinitialization, and unlike hard reinitialization, it 
does not affect other hosts, 

Tne steps involved in resynchronlzation are as follows: 

1, Thp host ceases issuing further commands to the controller, 

2, The host sets a soft Init timer and Issues a INIT command to 
tne controller and waits for the end response, when the 
controller receives this command, it will cease processing on 
all outstanding host requests that it can effectively stop, and 
will discard those commands. Commands that are too far along 
to be stopped will be finished and will terminate with normal 
END messages, 

3, The controller responds with an END message to the INIT 
command, 

4, If any outstanding host requests remain not completed when the 
END for the INii command is received, the host reissues these 
requests as appropriate. 



4,5,2.4,2 Reinitialization - 

As master, tne host is also responsible for reinitializing the 
controller under certain circumstances. 

Note that since relnltiailzatlori involves a cold bootstrap of the 
controller, At,L controller context relative to ALL hosts is lost during 
this process, Reinitialization is tnus a last ditch action taken when 
any other hostts) are attached to the same controller. Since It Is also 
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a time-consuming and wear-causing process, it must not be part of 
routine error recovery. 

Reinitialization consists of forcing the controller to perforirt a cold 
restart, then resynchronlzlng with it once (and if) it comes back; up. 

The steps involved in reinitialization are as follows: 

1, The host ceases issuing further commands to the controller. 

2, The host sets a hard Init timer and Issues a bus-level init 
command to the controller. It then waits for a REINITIALIZED 
command from the controller. As soon as the bus-level init is 
recognized, alJ perceivable activity in the controller will 
stop relative to all hosts. 

3, The controller will perform a cold bootstrap as if it was being 
powered up, when and if it passes its minimum integrity 
diagnostics. It will send a REINITIALIZATION message to all 
hosts in Its configuration tables. The controller is then 
online to ail nosts, 

4, If host requests were outstanding when the reinitialization 
process *as beaun or the reinitialized message Is received, a 
host reissues these requests as appropriate. 



4,5,2,5 Connection Establishment and Termination • 

The establishment of a logical connection between the host and the 
controller is automatic when the controller changes to the online state 
for all hosts in its configuration table. If the host is to use the 
subsystem in an optimal manner, the Configuration Seguence must be 
executed to determine the exact status of the subsystem and to set any 
Characteristics and/or status to other than the default values. The 
conectlon exists, from the controllers viewpoint, until the controller 
odnegoes offline. This may be done by a host during SlfSGEN or 
dynamically during each boot of the host. 



4,5,2,5,1 Configuration Seguence - 

The Conf lauration Seguence is used to determine the state of all aspects 
of the subsystem and to change any of the default characteristics and 
status by host co'Tiinand, 

The Configuration Sequence consists of the following steps: 

1, The controller enters the 'controller online' state due to hard 
initialization. The host win receive a REINITIALIZED notice 
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from the controller, 

2. Tne host issues a GET CHARACTERISTICS (UNIT«UN,CTR) command to 
the controller and waits for the END raessaqe, 

3, The controller responds with an END message with current 
subsystem parameters. The parameters are those pertaining to 
the subsystem as a whole and include an indication of how many 
logical units are attached to the subsystem, 

4, The host examines these characteristics, and if It desires to 
change any of them, it coordinates with any other host(s) 
attached to the controller, then Issues a SET CHARACTERISTICS 
(UNlTaUh.CTR) command to the controller and waits for the END 
message. The controller will respond with an END message when 
the new characteristics are in effect. This step of the 
protocol is optional; If the host does not wisn to change any 
of the characteristics, it does not execute this step, 

5. The host issues a GET STATUS fUNIT«UN,CTR) command to the 
controller ana iNdiLs tor the fc'<u messaqe, 

b. The controller responds with an END message with the current 

subsystem status. The status information contains status 
pertalnlnq to the subsystem as a whole, 

7, The host examines this status, and If It wishes to change the 
status of the controller. It Issues a SET STATUS (UNIT*UN,CTR) 
command to the controller and waits for the end message. The 
controller will respond with an END message indicating that the 
desired status changes have taken effect. This step of the 
protocol is also optional? If the host does not wish to change 
the status of the controller, it does not execute this step. 

After the above is completed, the host should do steps 2 thru 7 for each 
of the units attached to the controller which is of Interest to the 
host. 
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A diagram of tne configuration sequence follows: 

CONFIGURATION SEQUENCE 



Controller enters 'controller online' 

state. Controller issues 

REINITIALIZED notice to hostCs) 

I 

V 
Host issues GET CHARACTERISTICS (UnITsUN.CTR) 
command. Controller sends END message wltn 
the controller characteristics 

1 

V 

Host examines characteristics 

I 

V no 

Any changes? ------------ -----•+ 

• 

V 
Host issues SET CHARACTERISTICS 
CUNiTsUN.CTR) command. Cohtroller 
reacts and sends ENh rnessaqe 

V 
Host issues GET STATUS (UNIT=UN.CTR) 
command. Controller sends END message 
with the controller status 

« 
V 
Host examines status summary 

V no 
Any changes? ———-•---—-•-+ 

! I 

V i 

Host issues SET STATUS (UNIT«UN.CTR) 

command. Controller reacts and sends 

END message 
♦ 

m 

V 
Repeat all but the first step 
for each uhit. 



I 
V 
CONFIGURATION SEQUENCE FINISHED 
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4,5.2.5.2 Terminating Connections - 

There are occasions when the controller must unilaterally break the 
logical connection with the host in an orderly fashion. This occurs 
when an controller that is online to the host must go offline due to a 
Change in its host t>us enable switches, an FE command removing the 
subsystem from service, or the controller determines It must 
reinitialize and is still sane enough to breaic the connection 
gracefully, 

When the controller wishes to break its connection with the host, it 
simply sends a disconnecting attention message to the host and ceases to 
accept further commands (they are refused with the appropriate error 
indication. If possible). Commands that were outstanding at the time 
the messaqe is sent are allowed to complete, if possible. 

If the host wishes to break Its connection with the controller. It 
simply ceases to send further commands. 



4.5,2,6 Interpretation of LOG, END, ATTENTION, and PSUEDO-TERm out 
messages * 

The four types of m«»ssaqes sent by the controller to the host have the 
following broad interpretation: 

1, END messages signal the completion (successful or unsuccessful) 
of a command. There is one and only one for each command 
received. These must of course be processed by the host 
because their reception stops the timing of the command and 
operates as a completion signal to the driver and thus to the 
operating system. 

There Is summary unit status Information in the END packet 
which is processed as appropriate by the system. The unit 
status information is most useful to determine which error 
recovery procedure to Invoke for unsuccessful operations. More 
detailed utilization of the status information is a function of 
tne sophistication and needs of the host driver. The more use 
Is made of it In tne END packet, the less GET STATUS operations 
Should be necessary to recover from errors or maintain 
operating system tables, 

2, LOG messages transmit information for the error log. It always 
contains information correspondlno to an error condition In the 
subsystem, the severity ot which corresponds to the class of 
tne log message, LOG messages may or may not relate to a 
particular command, as Indicated in the message itself. 
Systems may ignore log messages and the protocol will still 
function. Systems of any sophistication should make the log 
thresholds variable by the SET CHARACTERISTICS command, and 
should log the information In a meaningful way. 
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3, ATTENTION messages notify the host of significant changes in 
subsystem status or significant events internal to the 
subsystem that should be of interest to the host system. 
Attention messages never signify an error condition, although 
they may signify a status change that is the result of an error 
condition. For example, if a drive overheats^ the host will 
potentially get two messages: a LOG message Indicating the 
overheating condition, and an ATTENTION message indicating that 
the drive is no longer available to the host. Other examples 
of ATTENTION messages are notification that a particular 
deteriorating sector on a disk warrants replacement or that the 
subsystem is changing status to write PROTECT, 

In order for the connection protocol to woric, REINITIALIZATION 
attention messages roust be at least minimally processed by the 
host. The interface will still function properly if other 
attention messages are ignored by the host. These other 
attention messages give sophisticated systems the capability to 
react dynamically to status changes within the subsystem. 

4, Pvjlituu-ictMi ijoT messaqes proviae a mechanism tor sending text 
to be displayed at a nost terminal which is being used as the 
HSC50 fe panel. The use of a psuedo-terminal must be 
explicitly enabled by the nost. The PSUEDO-TfciRM IN ani 
PSHFho-TERM OUT compands are used to transfer ASCII strings 
between the host and the controller. The communication is 
asynchronous. While enabled the messages cannot be ignored by 
the host. 



4,5,3 Shadowing 



4,5,3,1 General Rules Governing use of Shadowing - 

A shadow relationship may oe established between any two disk units, A 
disk unit may have only one shadow relationship. Any wRlTE to a unit 
with a shadow relationship will cause the identical WRITE on the otner 
unit. 

At the time the shadow relationship is established, the host may specify 
that the first unit is to be copied onto the second as a backround 
activity while the units are In use. Since the copy may not be 
perfornred sequentially, if an unrecoverable error occurs before the copy 
is complete, the state of the second unit Is undefined, Wnen the copy 
is completed, an ATTErrnON rciessage Is sent to the host, 

A WRITE operation to a shadowed unit on a cached system must be 
write-through, a write-oack operation to a shaaowed unit will be 
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rejected. 



4,5,3,1,1 Restricted Command subset Available on Shadowed Units, - 

Because shadowed disK units in a shadow relationship must be managed by 
the controller, there are certain commands that are not legal to units 

of this type. 

The following commands are illegal, except for breaiclng the shadow 
relationship, to a disk unit that is currently shadowing another disk 
unltJ 

SET CHARACIEHiSTlCS 
SKT STATUS 

A WRITE with COMPARE to a Shadowed unit will cause the compare to be 
performed for both units. 



4,5,3,2 EstabllshlnQ and Terminating Shadow Relationships - 

Shadowinq Is 3 symfpetrlcal relationship limited to two units of the disk 
Class type. Any WRITE operation to either unit Is reflected on the 
other. Shadow relationships will be controller level characteristics, 
established and terminated via the SET CHARACTERISTICS (UNIT « Un,CTR) 
command. 



4,5,3,3 Behavior of Shadow Requests Under Error Conditions - 

The END packet win not be sent for a shadowed WRITE until the the 
operation is completed on both units. If there is an unrecoverable 
error on one unit, e.g. a head crash, the controller will still attempt 
to complete the WRITE on the other unit. The host should then break the 
Shadow relationship to use the operational disk. 
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4,5,4 General Command Paclcet Format 

All packets consists of an 12 byte packet neader and a 24 byte argument 
area. Arguments are always multiples of two bytes. Multiple-byte 
arguments are in VAX-ll format. 

Command packets from the host to the controller are in the following 
general format: 



I 

• 

1 

header 

(12 bytes) 
f 

I 



I 



arguments 

(24 bytes) 
I 

I 

I 



t" 

/ 

/ 

+• 
i 



opcode 



• 



device class 1 
unit ! 

modifiers 1 

reserved • prior i 

• ----■•-•>-•>•.••-••-.«-.-•«....«••.. ^ 

low order reference number ! 

■"---"""•""----""--""""-•■-"--»-"""+ 
htah order reference number ! 

argument i 

/ 
/ 

argument i 

............... ...............^ 



Byte offset 
from start 
of packet 



2 

4 



6 

10 

12 



34 



The PRIORITY specifies the priority tor the command. The HSC50 will 
accept two priority levels -- normal: PR.NRM and high: PR, HI, 

The OPCODE field specifies the command. An opcode of 255(10) is 
interpreted as escape. in tnls case, the actual opcode will be taken 
from a \to be specifiedX argument word. 

The device class field specifies the device class of the unit to which 
the command is directed. The HSC50 will accept three device classes -- 
controller: DV.msc, disk: dv.dsk and tapes DV.Tap. All references to 

the cache are implicit through one of the other device classes. 

the UNIT numoer specifies the unit within the subsystem that the command 
refers to. Both the DEVICE CLASS and the UNIT are necessary to uniquely 
identify a specific unit. 



Unit UN.CTFv is the controller itself (and sometimes the entire subsytec 
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by implication). 

The REFERENCE NUMBER is an "ID" for the command. Note that it MUST BE 
UNIQUE for the outstanding commands of that host and it MUST NOT BE 
ZERO. 

The MODIFIERS specify variations to a comipand. 

There are several arguments which appear in a number of commands. They 
arei 

1, Byte Count -- specifies the number of bytes to be transferred 

2, Buffer Descriptor -- specifies the buffer in the host memory, 
always paired with a host port id 

3, Host Port ID -- specifies the oort id of the host to/from which 
data is to be transferred 

4, Blocic Number (LBN) — specifies the logical blocic number in the 

disk unit's storage 

5, Blocic Size — ■ specifies the block (physical record) size for 
tape class devices 

6, ttlock Count " specifies the number of blocKS for tape class 
devices 

7, Reserved — a field reserved for future use, MUST BE ZERO, 
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Message packets from tne controller to the host are in the following 
general formats 

Byte offset 
from start 
of pacicet 



f....> 



header 

(12 bytes) 
I 

I 

I 

« 

+— -> 
I 

m 

argunients 
(24 bytes) 
i 

I 
I 

+— — > 



+ • 
i 

I 
I 
I 



opcode I device class 
unit 
conditions 
reserved 






1 prior i 

f. .•«...•.•....•.•........ •..—•4. 

I low order reference nuwber 
I high order reference number 

I argument 

4......,........................^ 

/ / 

/ / 

4. .................. ............4 

I argument 1 

^•....-.••......••..............^ 





2 

4 

6 

8 

10 

12 



34 



The PRIORITY, OPCODE, DEVICE CLASS, UNIT and REFERENCE NUMBER are aS 
described for host-to-controller pacKets, 

The CONDITIONS specify command execution results, especially with regard 
to errors. 
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4,5,5 Host"-tO"Controlier Coffimands 

This section describes the individual commands the host can Issue to a 
controller. The numerical values for opcodes, modifiers, and other 
Dit-speclfic information ( such as the format of status and 
characteristics blocks) are in the tables at the end of the section. 

The discussion of each command Includes a statement describing the 
"gatekeeper class" of the command. This refers to the relationship that 
the command has to any other commands that are outstanding at the time 
the command arrives and any command that might follow It while it is 
still outstanding. The "gatekeeper" is a function Internal to the 
controller that decides when processing for a given command can begin. 
Commands that cannot be processed immediately are gueued at the gate, 
and are allowed to enter the subsystem by the gatekeeper when 
appropriate. Note that the gatekeeper does not impact wnether or not a 
command is accepted; all valid commands are accepted immediately. 
Rather, the gatekeeper forces serial processing on certain commandSf and 
its only visibility on the part of the host is the Increased latencies 
for comndads Dioc^ed at the gate, ine sjateneeper is required to proviae 
the LBN FIFO guarantee to the host, and to assure consistency of 
operation across classes of commands that affect subsystem parameters. 

There are five gatekeeper classes: 

1, GET STATUS Class, GET STATUS Class commands have no Impact on 
any activity in the subsystem and always begin processing 
immediately unless they are blocked at the gate by a SET STATUS 
class command, GET STATUS class commands do not block other 
commands, 

2, READ Class, A READ Class command is allowed to enter the 
subsystem immediately and begin processing as long as its entry 
Is not blocked by a wRITE class or SET STATUS class command 
that preceeded it, READ class commands do not block any 
commands that may follow It, 

3, WRITE Class, A WRITE Class command is allowed to enter the 
subsystem and begin processing only If no other commands to the 
same lbncsj are already In the system, and the gate is not 
closed by a SET STATUS class command. It another command 
involving one or more of the same LBN(s) is already in the 
subsystem, the l»RITE class command is queued at the gate, and 
does not begin processing until all previous commands to tne 
<9ffected r,RMs complete, WRTTF class co^-^ands will block any 
commands that follow It that Involve one or more of the same 
LBNis until the i^HIlE class command itself has completed, 

4, SET STATUS class. SET STATUS class commands affect the 
operation of a unit or the subsystem Itself, Therefore, they 
do not enter the subsystem until all outstanding operations to 
the affected unlt(s) are complete, and any operations to the 
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affected unit(s) that follow it are blocked at the gate until 
the SET STATUS Class command itself completes. If the SET 
STATUS class command operates on the controller, all 
outstanding requests are completed before it is begun, and it 
is the only command allowed to be active until it completes, 

5, Immediate Execution class, IMIT and ABORT are Immediate 
Execution class commands and are not delayed for any reason by 
the gate Keeper, 
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4,5.5,1 ABORT - 

Format: 



I 

+■ 
I 

* 

t- 

I 

+■ 

I 



ABORT 



i device class 
reserved 
moditiers 
reserved 



i low order reference nutnber 






1 high order reference nut^ber 

4.. ...................... ».-.... 

I low order abort re£ number 

1 high order abort ret number 

^...... ........ ................ 

1 reserved 

+--.--..-«—.«-..«—■«....— «^ 

/ / 

/ / 

^...............................^ 

J reserved J 

^..•..•.«-.— .••...••.•....•••.•••.4. 



Byte offset 
from start 
of packet 



2 

4 

6 

8 

10 

12 

14 

16 



34 



Allowable Unltss 



Must be the same as in the comwand to be aborted. 
Arguments? 



Reference number of the command to be aborted. 
Function and Kesultss 



The specified command is aborted at the earliest point convenient for 
the controller. If any-unlt affecting action has already oeen taicen, an 
FMT) messaoft for the orlolnal command Is sent to th#» host indicating the 
the degree of commano execution(e,g, , nufliber of pytes transferred.) if 
no action rias yet peen taxen, the EHu fiiessaqe smIH so in'^ilcate. After 
the abort action has been completed, an knd message for the ABORT 
command is sent to the host. 

When the end for the abort Is received by the host, the original command 
is no lonaer active in the subsystem. 
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Gatekeeper Classj 



ABORT is an immediate execution class command like INIT and bypasses the 
gate keeper, 

ABORT END Packetj 



Allowable units: 

Same as in the original comiDand packet. 
Conditions: 



Error - abort reference number not a current outstanding reference 
number. 
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4.5.5.2 COMPARE - 
Format: 



I 
I 

I 

+• 
I 



COMPARE I device class 
unit 
modifiers 
reserved j prior 



••♦■ 



J low order reference number 

I hlgn order reference nuf^ber 

4-.. ..................... .«.._, 



+- 
I 

+ ■ 
I 



low order byte count 
high order byte count 
low order buffer descriptor 



•4- 

I 

• + 



1 hiqh order buffer descriptor 

I low host port id 

+—.-.-....-..-..„...,.........+ 

I high host port id 1 

i low order LBN or block: size 

^.. ...................... ...... 

i high order LBN or block: count 

t.... ................. ....._..«. 

I reserved 

/ / 

/ / 

1 reserved • 



Byte offset 
from start 
of packet 



2 


4 


6 


8 


10 


12 


14 


lb 


18 


20 


22 


24 


26 


28 



34 



Allowable Units: 



Any other than un.ctr. 
Arguments: 
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Byte Count 
Buffer Descriptor 
BXocK Number 

Function and Results: 

COMpAHE directs tne controller to compare a specified number of bytes 
from the specified unit against host memory. Although the data compared 
Is contiguously organized, the comparison itself may not occur 
contiguously. The co-npare terminates when the byte count is satisfied 
or an error occurs, 

GateKeeper Classj 



COMPARE is a READ class command. 
Special Comments: 



If the LBN being compared happens to reside In tne cache, the compare 
operation results in a f-'LUSH ot tne cacne data. Invalidation of 
the cache entry, and a read of the data from the dlsic without a reload 
into the cache, 

COMPAHE EtiD Packet: 

Conditions: 



Error - Compare failure, relative byte number where compare failed 
follows the last argument of the normal end pacicet. 
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4,5,5.3 DOWNLINE LOAD - 

(Only on the UDA50, not implemented on the HSC50) 



Format: 



DOWNLINE LOAD I device Class • 

unit 1 

modifiers 



+ ■ 

I 
+• 



reserved 
low order reference number 
high order reference number 
low order byte count 
ni>jM order oyte count 
low order buffer descriptor 
high order buffer descriptor 
low host port id 
high host port id 
memory blocJc descriptor 
relative position in block 
reserved 



/ 
/ 
♦ ■ 



■+ 
1 



reserved 



>+ 
I 

•■¥ 

I 

# 

• + 
i 

•+ 
1 

• + 
/ 
/ 

• + 
I 

■ + 



Byte offset 
from start 
of packet 


2 

4 
6 
8 

10 

12 
14 
16 
18 
20 
22 
24 
26 
28 



34 



Allowable units? 



Any unit in the uOAb^' subsystem *hicn is capable ot accepting dowline 
loading of code. 



Arguments i 
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Byte Count 
Buffer Descriptor 
Memory Descriptor 

Modifiers; 

None 

Function and results: 

The contents of the host buffer are loaded into the unit's raeiiiory 
beginning at the relative position In the specified memory bloc^c, 

\The forsBat of the downline load Information is to be specified in a 
document by Bill Grace. The information must Include the specification 
of each of the rtn descriptors which may be used in a subsequent EXECUTE 

comme»nd.\ 

Gatekeeper Classj 

DOWNLINE LOAD Is a SET STATUS Class command. 
DOWNLINE LOAD END Packet: 



Defined conditions: 

Error - Space available in the unit is Inadequate for the routine. 
Error - Another routine is In execution on the unit. 
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4,5.5.4 EXECUTE - 

Format: Byte offset 

...... from start 

•»■.-.— .......................... .f of packet 

I EXECUTE i device class J 

♦..-..—...-...-.-........—....+ 

i unit I 2 

+-...............„.............+ 

1 modifiers 1 4 

I reserved ! 6 

1 low order reference number i a 

I high order reference number I 10 

1 low order byte count J 12 

t...............................^ 

1 high order byte count I 14 

+ — ... — ..---.---.-.. ......^. 

i low order buffer descriptor l 16 

i hiqn oraer buffer descriptor 1 1^ 

J low host port Id 1 20 

I high host port Id i 22 

! low order rtn descriptor ! 24 

J high order rtn descriptor J 26 

I rtn argument I 28 

/ / 

/ / 

i rtn argument i 34 



Allowable Units: 

UN.CTR only on the H&C50, On the iiUASo, any unit that has the 
capability. 

Arguments; 
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Byte Count 
Buffer Descriptor 
Routine Descriptor 
Routine Arguments 



Function and Resuitst 



The specified routine Is executed and the results returned to the host 
buffer. If the buffer descriptor is zero the results are returned In 
the END message. 

Gatekeeper Class: 

EXECUTE END Packet! 



Defined condition&j 

Error - routine aoes not exist Error - argument list wrong size Error 
a routine is In execution on the unit 
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4,5.5,5 FLUSH - 
Forrnat! 






FLUSH 



+■ 
I 



t device class • 

unit I 

"-"•-------■—-—----"+ 

modifiers • 



reserved 
low order reference number 
high order reference number 
reserved 



+■ 
/ 

/ 
+ ■ 



reserved 



I 
■+ 

« 



Byte offset 
from start 
of packet 



2 

4 

6 
8 

10 
12 



34 



Allowable units: 



UN.CTR or any disk unit. UN.CTR causes the entire cache to be flushed. 
Any other unit causes only those entries for the specified unit to be 
flushed. 

Arguments J 



None, 

Function and results: 



A FLUSH command directs the controller to search its cache tables for 

dirty entries that correspond to the specified unit, and if any such 

entries are found, to *filTE the^i out to the disk. Ihe end packet is 
sent when all dirty entries have been written, 

ftfter flashing any Jlrty data fron. the cache, the controller leaves the 
entry in the cache, but marks it as clean. 

If no dirty entries corresponding to the specified unit are found, this 
command is effectively a very slow NOP. 
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Gatekeeper Class: 



FLUSH is a SET STATUS Class cotntfiand. 
Special Comwentsj 



FLUSH is primarily useful as a means of "comnnitting" temporary or 
tentative data to the disk in a wrjte-back environment. 
FLUSH END Packet: 



Defined conditions: 



Preliminary HSC50 Host interface Version 0,9 (18-Juiy-79, Mitchell, Bean)PAGE 4»56 
Digital Equipment Corporation — company CONFIDENTIAL 



4,b.5,6 GET CHARACTERISTICS - 

Format: 

+——.-.....«....-.-...-, — .+ 

1 GET CHAR J device class • 

+————..-.-_....-.,.... .^ 

I unit I 

^-,— ..-.....„...._..„«... .....^ 

I modifiers 1 

! reserved j 

I low order reference number 1 

+ --——-.— —...«■...,-..«.«.+ 

I high order reference number ! 

i reserved j 

4.—————--—.—-—--.--—.-.+ 

/ / 

/ / 

+———.„.—»«....«.«.......,. ^. 

{ reserved I 



Byte offset 
from start 
of packet 


2 

4 

6 

8 

10 

12 



34 



Allowable Units: 



Any. 



Arguments: 



None* 



Function dnd Results: 



The specified unit's characteristics are returned in the END packet, A 
definition of the cnaracterlstics format can be found in Section 4,5,7, 

Gatekeeper Class: 



GET ChARACTLRISTlCS is a GET STATUS class comrr-dnd, 
GET CHARACTERISTICS E(vD Packet: 
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Defined Conditions: 
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4,5,5,7 GET STATUS - 
Format: 



i GET STATUS ! device class J 
i unit 1 

modifiers 



reserved 
low order reference number 
high order reference number 
reserved 



/ 

/ 



Byte offset 
from start 
of packet 


2 

4 

b 

8 

10 

12 



reserved 



34 



Allowable Units: 

Any. 

Arguments: 

None, 

Function and Results: 



The status of the specified unit is returned in the END pacicet, 
format of the status returned is given in Section 4,5,7, 

Gatekeeper Class: 



The 



GET STATUS is of course a GKI STAK-s Class cofrroand. 

Special Comrr.ents: 

GET STATUS END Packet: 
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Defined Conditions; 



Preliminary HSC50 Host Interface Version 0,9 C18-July-79, Mitchell, Bean)PAGE 4-60 
Digital Equipment Corooration --cOHPANjf CONFIDENTIAL 

4.5,5,8 INIT - 



Format: 



Byte offset 
from start 
of packet 



2 


4 


6 


8 


10 


12 



i INIT ! device class i 

i unit J 

i modifiers I 

{ reserved j 

! low order reference number J 

i high order reference number i 

f— ..—..--........-«......-...+ 

! reserved » 

/ / 

/ / 

1 reserved j 34 



Allowable Units: 

UN,CTR only. 

Allowable Modifiers: 

None 
Arguments: 

None. 

Function and Results; 

An INIX command is used as descriDed in tne resyncnronlzation section to 
resynchronize with the controller. It causes the controller to cease 
processing on any outstanding host commands, and to reinitialize all 
internal context relative to tne initializing host. The controller does 
not stop runnina; It merely clears the controller of all commands 
relative to the issuing nost and returns to default characteristics and 
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status for that host only. The other host (If any) is not affected. 
Any outstanding requests that are successfully stopped by the controller 
are not responded to; they are "lost". The controller will respond 
with an END packet when the soft initalllzation is complete (all 
outstanding operations are cleaned up and internal context Is in an 
initial state). 

Note that this INIT function is distinct from and much less drastic than 
a bus-level hard Inlt, 

Gatekeeper Class? 



Because iNlT it^ust begin its work immediately, it Is a special case 
command. It is never blocked at the gate. 

Special Comments: 



When the controller receives an init command, it attempts to stop the 
processing of any host requests that are already in progress, because 
of parallelism within the controller, however, it is impossible to stop 
processing on requests that have passed a certain internal processing 
point. Therefore, the host should oe ready to process end packets 
corrrespondlnq to any oiitstandlnq requests even after a Init command has 
been sent. The host should remain ready to process END packets for 
outstanding commands until the END packet for the INIT itself is 
received, at which point the host can be assured that no further end 
packets will be forthcoming, 

INIT END Packet: 



Defined conditions: 



Preliminary HSC50 Host interface Version 0.9 (18-Juiy-79, Mitchell, Bean)PAGi!: 4-62 
Digital Equipment Corporation --COMPANY CONFIDEf^TIAL 



4,5.5.9 iNVALlDATfe; - 

Format: 



+• 
+• 



I^iVAl,IOATE i 
unit 
moditlers 
reserved 



device class I 



I 



! prior 1 

*■"""■'"■"""•""■""•-----"—----—---♦ 
low order reference numper I 

high order reference nu^Per • 

"■"""""•"••■--"-----------------+ 

reserved » 

+— — — — — — — .^ 

/ / 

/ / 

+.-« —«.———«..-.-». ....4 

reserved 



+« 

/ 

/ 

+• 
I 



low order LBN 
high order l&n 
reserved 



reserved 



•+ 
I 

■+ 
/ 
/ 

"f 
I 

•+ 



Byte Offset 
from start 
Of pacicet 


2 

4 

6 

8 

10 

12 



20 
22 
24 
26 



34 



Allowable units: 



Any disk class unit. The unit qualities the LBN arqument to indentlfy 
the unique cache lbn to oe invalidated. 

Arguments: 



The block nutnber specifies *hicn Lbk on the specified unit is to be 
invalidated. 



Function and results: 
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This command directs the controller to delete the specified LBh from the 
cache directory without a write-back of the dirty data. 

This command is a limited-use command provided to allow the host to 
recover from errors resultina from failure of a CCD block that contains 
"dirty" write-back data? it eliminates the error that occurs on reads 
from "bad" dirty cache blocks. Its main use would occur when a 
temporary file Is deleted after a cache block failure. The disk hBH 
would now become available for normal operations, while the "bad" cache 
block(s) remain out of service. 

Gatekeeper Class: 



INVALIDATE is a WRITE class Command, 
INVALIDATE END Packet; 



Defined conditionsj 
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4,5,5,10 NUP - 
Formats 



■♦■• 
I 



NOP 



device class 1 



+« 
I 



unit 
modifiers 



reserved 



low order reference number 



• 
•+ 

I 
■"♦■ 

t 



I Mgh order reference number 

^. ................... ......... 

i reserved 



/ 
/ 



/ 



reserved 



Allowable Units: 

I 

UN.CTR only, 

[ Arguments: 



Byte offset 
from start 
of packet 



2 

4 

6 

8 

10 

12 



34 



None, 

Function and Hesultsi 



Tnis command causes tne controller to respond witn an K^u pacKet without 
performing any internal operations other than that necessary to respond, 
lilice all END packets, the response to this command contains summary 
status information for the specified unit. 



Gatekeeper riass: 



NUP Is a GtT SIATUS Class command, 
NOP KND Packet! 



Uetlned conditions; 



Preliminary HSC50 Host Interface Version 0,9 (i8-July-79, Mitchell, Bean)PAGE 4-65 
Digital Equipment Corporation — company CONFIDENTIAL 



Preliminary HSC50 Host Interface version 0.9 C18-July-79, Mitchell, Bean)PAGE 4-66 
Digital Equipment Corporation — COMPAmy CONFIDENTIAL 

4,5,5,11 POSITION - 

Format: Byte offset 

"■"""" frojn start 

+«„--«««.«...«..«.,..-«-««.,,,+ Qf oaclcet 

I POSITION i device class J 

4-.... «._..«. _«.,,. ....... ......+ 

i unit I 2 

1 modifiers i 4 

+—,-.-....-.......-........ ....^ 

1 reserved j 6 

+—-—..-.-...-.....-. --..+ 

I low order reference number l 8 
+....— .........................^ 

5 hioh order reference number J lo 

+—................. ...-.-..+ 

J operation count ! 12 

I reserved I 14 

<- + 

/ / 

/ / 

+.---. -....-...--.-......._+ 

I reserved ! 34 

Allowable Units! 

Any tape class unit, 
Argutnentss 



Operation Count 
Allowable modifiers; 

1, PO,FIL — POSITION to file. 

2, PO.BOT — POSITION to beginning of tape CrEwind). 

3, PD.UNL -- POSITION and unload. This modifier is used only in 
corlunciJon Altn pn.ROf dnd causes an unload atter the rev»ind, 

4, Pu.LKI -- PusiXlOiM to logical end-of-tape, 
Functiori and Results! 
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If there are no modifiers, the tape is positioned relative to blocks. 
If PO.FIL is set, the tape is positioned relative to file marxs. in 
these two cases, the operation count specifies the number of positions 
and the sign specifies the direction (forward if positive, bacKward if 
negative,) If PU,BOT (and optionally PQ.UWL) or PO,LET is set, the 
specified positioning occurs and the operation count is ignored, 

Gateiceeper Classi 

POSITION is a SET STATUS Class command, 

POSITION END Packet; 

Defined conditions: 
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4,5,5,12 PSUEDU TfciRM IN - 
Format: 



1 PSUEDQ-TEHM IN! DV.MSC I 
I UN.PST I 

i modifiers J 

+•.«...........•__... ...........4 

I reserved l 

f...... .«•«..«.«..«....._. ......^ 

I low order reference number i 
1 high order reference nun^ber i 

! byte 1 I byte count i 

+-«———«-■——.««...-«-...— + 

1 byte 3 I byte 2 1 

/ / 

/ / 

! and last byte or two bytes I 

/ / 

/ / 

I reserved i 



Byte offset 
from start 
of packet 


2 

4 

6 

8 

10 

12 

14 



34 



Allowable units: 



UN.CTR, 



Arguments: 



The byte count is the length of the ASCII string which follows it in the 
command packet. 

Function and results: 



The PSUEDO-TERM In conn^and directs the controller to obtain the ASCII 
string froni the comniand packet, and to process the string therein as if 
that Information was entered at the HSC50 FE panel, when the input 
string has been successfully accepted , tne END packet is returned to 
the nost. 
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PSUEUO-TERM IN commands are not required tor normal operation since the 
functions can be invoked at the FE panel. 

Gatekeeper Class: 

PSUEDO TERMINAL Is a SET STATUS class command. 
Special Comments? 



The PSUEDO-TEHM IN and PSUEDO-TERM OUT messages serve to provide an 
alternate path for conversing with the HSC50 controller via its terminal 
interface. The interactions that occur across the psuedo-termlnai are 
identical to those that occur on a physical terminal attached to the 
controller? the difference lies In the mechanism CICCS vs ASCII line), 
and the fact that a program as well as a human can interact with the 
psuedo-terminal. 

It Is expected that one mode of host utilization will be a 

"pass-throuvjn" dpplicatloii proyra-n tnat accepts anu prints 

psuedo-terminal strings on a nost user terminal, maiclna that terminal 
appear as if it were attached directly to the H5C50, 

The PSUEDO-TEKM !« command exists to allow any operation that can be 
performed at the HSCSO FE panel to be performed from the host as well, 

\The syntax and semantics of all possible FE panel interactions must be 
defined for the HSCSo, This set will be valid for the PSUEDO-TeRM in 
command, \ 

PSUEDO-TERM IN END PacKet: 
Defined conditlonss 
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4.5.5,13 
Formats 


RLAD - 

+ - 

^ m 

+«■ 

/ 

/ 

+ - 

« 
■f- 






-+ 
-+ 
•t 
-+ 

-+ 
-+ 

-•f 
-+ 
-+ 

-♦ 
/ 
/ 

-+ 
1 


Byt 
frc 
of 


.e offset 
m start 
packet 






REAO i device class 






unit 


2 






modifiers 


4 




reserved • prior 


6 




low 


order reference number 


8 




hiqt 


order reference number 


10 






low order byte count 


12 






high order byte count 


14 




low 


order buffer descriptor 


16 




high 


order buffer descriptor 


la 






low host port id 


20 






high host port id 


22 




low 


order LBN or block size 


24 




high 


order lbn or block count 


26 






reserved 


28 














reserved 


34 



Allowable Units: 

Any unit except uw.CTR, 
Arguments: 



8yte Count 
Buffer Descriptor 
Blocn number 
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Block Count 
Block Size 

Allowable modifiers; 

1. RD,ne:c — REhD no ECC Correction. Causes the read to return 
the data without any ECC correction applied. 

2, RD.REV -- READ reverse. Used on tape units only to READ In the 
reverse direction, 

3, RO.CMP -- READ with compare. Causes the READ to be followed by 
a COMPARE after the read data has been shipped to the host 

memory. 

4. RD.NOC -- READ no cache. Causes a cached system to FLUSH the 
specified LBN if it is in the cache and dirty, invalidate the 
cache entry, and read the aata from the dls»c without loading it 
into the cache. If the LBN is not in the cache, this modifier 

causes a uisK reaa without ioaamy the dIock. into tne cache. 

Function and Results: 



READ directs the controller to transfer the specified number of bytes 
from the specified unit to host memory. The contents of the loaically 
contiguous device locations which begin with the first byte of the 
specified block are transferred to the virtually contiguous locations in 
host memory beginning at the first byte location specified by the buffer 
descriptor. Although the data transferred is contiguously organized, 
the transfer itself need not occur seguentiaily. The transfer 
terminates when the byte count is satisfied or an unrecoverable device 
error occurs. An end message Is then sent containing summary status 
information. 

For a tape class device, the block specifies the expected number of 
bytes in each block and the block count specifies the expected number of 
blocks required to satisfy the byte count. If the block count is 
negative, the read is in the reverse direction. 

Gatekeeper Class: 



HEAD is Of course a HEAD CLASS comnsand, 
READ END Packet: 



Defined conditions: 
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4.5.5,14 SET CHARACIfcRISTICS - 
Format: 



SET CHAR 



i device class I 

.....................^ 

unit 1 

...•••..... ..••......^ 

modifiers 1 

.....................^ 

reserved j 



low order reference number i 

high order reference number 1 

.......................... _.._«^ 

characteristics block » 

/ / 

/ / 

i characteristics biocic ! 



Byte offset 
from start 
of packet 


2 

4 

6 

8 

10 

12 



34 



Allowable Units: 

Any that has settable characteristics. 
Arguments: 



Characteristic Block 
Function and Results; 



fcach of the specified characteristics is set to the specifiea value. 
description of the characteristics is found in Section 4,5.7, 



Gatekeeper Class 



SKT CHARACThRlSTirS is a 5t/I STATUS CldSS command. 
Special Comments; 



The controller will honor changes tor characteristics changes from any 
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host. The hosts in a multiple-host environment are responsioie for 
coordinating characteristics changes so that they do not oegin working 
at cross purposes, 

SET CHARACTERISTICS END Paclcet: 
Defined conditionsj 
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4.5.5.15 SET STATUS - 
Format! 



1 

• 


SET STATUS i device class 


-♦ 


• 


unit 


*T 


i 


modifiers 


"T 


» 


reserved 


"T 


i 


low order reference number 


"T 


J 


high order reference number 




1 

• 


status block 




/ 




/ 


/ 




/ 


J 

+ - 


status blocK 


I 

-+ 



Byte offset 
from start 
of packet 




4 

6 

8 

10 

12 



34 



Allowable Units: 



Any other than a disk unit shadowing another disk unit. 



Argumentsi 



Status Block 
Function and Results: 



Each specified status is set to the specified value, 
the status format can be found in Section 4.5,7. 



The description of 



Gatekeeper Class: 

SET STATUS is Of course a SET STATUS Class conimand. 
Special Comments: 



The controller win honor requests for status changes froni any host. 
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The hosts are responsible tor coordinating status changes to units they 
are sharing, 

SET STATUS END Packet: 
Defined Conditions: 
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4,5,5.16 wRITt. - 
Formats 



+ • 
+> 



WHITE 1 device class 
unit 
modifiers 
reserved i prior 






i low order reference nunriber 

^. •*............•..••. ........ 

high order reference number 



low order byte count 
hlcrh order byte count 
low order butter descriptor 



high order buffer descriptor i 

+«•--------------------"---------•► 

I low host port id J 

i high host port Id I 

^...1... ................ ..•••.-••^ 

low order LBN or blocK size J 

..............................4, 

high order LBN or block count 1 

.•.•..•......•.......•..•.....4. 

low order RBn or i 

..............................^ 

high order RBN or 1 

..............................^ 

reserved i 

.............................. t 



i 



reserved 



I 
•+ 



Byte offset 
from start 
of packet 


2 

4 

6 

8 

10 

12 

14 

lb 

18 

20 

22 

24 

2b 

28 

30 

32 

34 



Allowable Units: 



Any unit other than UH.CTR, 



Argutrientsi 
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Byte Count 
Buffer Descriptor 
BlocK Number 

Replacement Block Number 
Block Size 
Block Count 

Allowable modifiers: 

1, WR.CMP -- viRiTE with Compare, causes the WRITE to be followed 

by a COMPARE after the data has been written on the disk, 

2, yiR.BCK -- WRITE back. Causes a cached system to load the data 
into the cache as "dirty" data. The default is write-through, 

3, WR.NOC -- WRITE no cache. Causes a cached system to invalidate 
any cache entry corresponding to this LBN and then write the 
data to the disk, 

4, ..R,MDS -- rtRITE no sliaao*. Causes tne controiier to avoid 
shadowing this write wnen the target unit is shadowed. If the 
target unit is not shadowed, this modifier Is Ignored, 

5, wR.pfrp -- WRITF" with replacement. Causes the susbsystem to 
replace the bad LBN with a replacement block and write the data 
into the replacement block. This modifier limits the byte 
count to one sector. The RBN must be zero for the HSC50 since 
it determines the actual R8N, 



Function and Results: 



WRITE directs the controller to transfer the specified number of bytes 
from host memory to the specified unit. The contents of the virtually 
contiguous memory locations which form the host buffer are transferred 
to the logically contlQuous device locations which begin at the first 
byte of the specified block. Although the data is contiguously 
organized the transfer itself need not occur sequentially, Xne transfer 
terminates when the byte count is satisfied or an unrecoverable device 
error occurs. An end message is then sent containing summary status and 
the number of bytes successfully transferred, 

Gatekeeper Class: 



WRITE is Of course a write class comwand, 
WRITE Er^D Packet: 
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Defined conditions: 
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4.5.5,17 WRITE TAPE MARKS - 
Format: 



+■ 



WRITE TFMKS I DV.TAP 
unit 

ffiodifiers 

reserved 
low order reference numoer 



•+ 
I 

\ 

■ + 

■ + 



■t- 

I 

t — — — «— — -.-- — -..-.. — — + 

I high order reference nu^^ber ! 

i operation count ! 

! reserved l 

+ .---.-,-.,----..------ + 

/ / 

/ / 

1 reserved ! 



Byte offset 
frojp start 
of packet 





4 

6 

8 

10 

12 

14 



34 



Allowable units: 

Any tape class unit. 
Arguments: 



Operation Count 



Allocable modifiers; 



1, WT.MRK -- WRITE TAPE marK, Causes the subsystem to write a 
tape mark; on tne specified unit, 

2, wT,fc;GP — WRITE extended gap, causes the controller to write 
an extended gap on the specified tape unit, 

3, wx.DSE -- Data Security Erase tape. 

4, wT.LET -- WRITE Logical End of Tape, 
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Function and Results: 



The operation specified by the fjiodifiers is performed the number of 
times specified by the operation count. 

Gatekeeper status: 



WRITE TPMRKS is a SET STATUS Class command. 
WRITE TPMRKS END PaclcetJ 



Defined conditions: 

Error - unit is not a dlsic 
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4,5,6 Controller-to-Host Messages 

This section describes the individual messages the HSC50 controller can 

send to the host. The numerical values for opcodes, conditions^ and 

other bit specific Infortnatlon (such as status and log blocks) are in 
the tables at the end of the section. 



4,5,6.1 END 
Format: 



END 



device class 



unit 



conditions 



reserved 



i prior I 



1 low order reference number ! 

^...............................^ 

I high order reference number J 



I 
+• 



low order byte count 



I 

•+ 



i high order byte count 



summary status 



shadow unit 



shadow summary status 



tot prob cnt i prob list cnt 



prob ind l i prob blk I 



+• 

/ 

/ 



■+ 
/ 
/ 



Byte offset 
from start 
of pacxet 


2 

4 

b 

8 

10 

12 

14 

16 

18 

20 

22 

24 



1 prob ind n i prob blk n i 
i reserved l 



2n + 22 
2n + 24 



/ 
/ 



/ 
/ 



« 



reserved 



» 
■t 



34 
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Allowable units: 

Same as in the original comtiand packet. 
Arguments: 



Byte Count 

Total Problem Slock Count 

Problem Blocic List Count 

Problem Block List 

Summary Status 

Shadow Unit hiumber 

Shadow Unit Summary status 



Defined conditions; 



All condition codes defined In the tahie in Section 4,5,7,3.1 can be 
returned. 

Function and results: 



End Is a synchronous message to the host signifylnq that the controller 
has completed processing the command with the specified reference 
number. The condition field provides status relative to the command. 
The summary status fields provide status relative to tne units. See 
Section 4,5,7,3 for a specification of the conditions field. See 
Section 4,5,7,4 for a specification of the summmary status fields. 

Special Comments: 



The host must be prepcired to receive END packets for which there is no 

outstanding command. This would oe an error on the part of the 

controller, but the class driver should not "crash". Recommended 

procedure Is to consider receipt of an unexpected SNO packet as 
equivalent to cosrimand timeout. 

The problem dIocr list is the set of blocks in error or which caused tne 
ECC threshold to be exceeded during readlnq, Tne total oroblem block 
count is the number of blocks that had problems. The problem list count 
Is the number of blocks which had problems and are identified in the end 
packet. The problem indicator has bit 7 set if tnere was a hard error 
and bit 6 set if the block was on the shadow unit. Bits 0-5 are 
reserved. The problem block byte is the relative blocK number from the 
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starting LBN , 
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4,5,6.2 ATTeNTION - 



Format: 



ATTENTION 



J device class J 



I 



unit 
conditions 



{ 



reserved 



I prior 



low order reference number 



high order reference nu^nber 



+• 
/ 
/ 
+ ■ 
I 

+■ 



reserved 



reset vea 



summary status 



reserved 



reserved 



■+ 
/ 
/ 

■+ 
I 



Byte offset 
from start 
of pacJcet 


2 

4 
6 
8 

10 

12 

!•* 
16 
19 



34 



Allowable Units: 
Any 

Arguments: 

Summary status 
Defined Conditions: 

Any of tne conditions aeflned in Section 4,3,7,3,2, 



Function and Results: 
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ATTENTION is an asynchronous message from the controller to the host and 
is not acknowledged by the host with any corresponding message. 
ATTENTION signals the host of a change In the specified unit' status or 
characteristics. The conditions and summary status contain the 
Information specifying the change and current status. 
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4.5.6.3 
Format; 



LOG - - 



LOG 



i device class 



unit 



conditions 



reserved 



I prior 



low order reference number ! 



high order reference number 



reserved 



byte count 



reserved 



summary status 



I nyte 2 

/ 

/ 



+• 
+« 



reserved 



1 byte 1 1 

/ 
/ 



{ and last byte or two bytes I 



/ 

/ 

•+ 

I 



Byte offset 
from start 
of pacKet 



2 


4 


6 


8 


10 


12 


14 


16 


18 



34 



Allowable Units? 
Any 

Arguments J 



Summary Status 
Log information 



Function and Results; 
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LOG is an asynchronous message from the controller and is not 
aclcnowledged with a corresponding message. The error logging 
information may pe the result of processing a specified coiniriand 
(identified by the reference number) or may be unrelated to any specific 
command (reference number is zero). 
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4,5,6.4 PSUKDO-TERM OUT - - 



Format: 



PSUEDO-TERM OUT! DV.MSC 



UN.PST 



reserved 



reserved 



low order reference number 



i L>Yte i 

/ 

/ 



Dyte 2 



% 

• 



reserved 






high order reference nu^iber 

♦—----"---------"—-----—---+ 

i byte 1 1 byte count 1 



■•♦■ 
/ 
/ 



t and last byte or two bytes I 

^. «....•..•.•...•.••...••««... ..4. 

/ / 

/ / 



I 
>+ 



Byte offset 
from start 
of packet 



2 

4 
b 
8 

10 
12 

14 



34 



Allowable Unit; 



Psuedo-termlnal unit number 



Arguments: 



Byte Count 
ASCII String 



Function and Results: 



PSUEDO-TKRM OUT provides tne host with a string to be displayed on the 
"psuedo-termlnal". 
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Special Comments: 



These messaqes are normally not sent, A host must set a controller 
characteristic to enable them. 



Preliminary HSC50 Host Interface Version 0.9 (18-July-79, Mitchell, Bean)PAGE 4-91 
Digital Equipment Corporation --company confidential 

4.5,7 Blocic and Symbol oetinition Tables 



4.5.7.1 


Opcodes - - 






Opcode 


hex 




ABOPT 


- C3 




ATTENTION 


- r3 




COMPARE 


- 33 




DOWLINE LOAD 


- A3 




END 


- F5 




EXECUTE 


- A5 




FLUSH 


- 63 




GET CHAR 


- 93 




GET STATUS 


- 95 




INIT 


- C5 




i^tVALluMlK 


- bb 




LOG 


- Fb 




NOP 


- 35 




POSITIGNi 


- 53 




PSUFDO-TERM IM 


- A6 




PSUEDO-TERM OUT 


- F9 




READ 


- 36 




SET CHAR 


- 96 




SET STATUS 


- 99 




WRITE 


- 39 




WRITE TPMRKS 


- 55 



4,5,7.2 Modifiers - 
Mnemonic Bit 



PO.FIL 


15 


PO.BOT 


14 


PO.UNL 


13 


PO.LET 


12 


RD.NEC 


15 


RD.REV 


14 


RD.CMP 


13 


KD.NOC 


12 


«R,CMP 


1 i 


rtR.BCK 


11 


i*.R.NOC 


12 


WR.NOS 


10 


WR,Rt.P 


9 
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IKT.NRK 11 

^T.EGP 10 

WT.DSE 9 

WT.LET 12 

MD.EXT (modifiers escape) 



4,5.7,3 Condition Codes - 



4.5,7.3,1 Condition Codes tor END - 

Bit 15 - Succeed(0)/Failure(l) 

Bit 14 - 1 If a protJlem blocic list included in END packet 

Bit 13 - i if LCC threshold exceeded 

Bit 12 - 1 if other recording error (header compare or eoC) 

Bit 11 - I if unit context Incompatible with command 

Bit 10 - I it command packet Invalid 

Bit 9 - I if command failure in executlon(COMPARE) 

Bit 8 - Reserved 

Bits 7-0 - Error code number specific to one of the above errors 



4,5.7,3.2 Condition Codes for ATTENTION - 

Bits 15-8 - Reserved 

Bits 7-0 - Attention code 

REINIT - 3 

CH-CHG - 5 (characteristic change) 
ST-CHG - 6 (Status change) 
SH-Cpy - 9 (shadow copy complete, 
units in bytes 12-13) 



4,5.7,4 Summary Status Eorwat - 

Bits i3-14 - General status 

00 - Unit online 

01 - Unit available 

10 - unit offline 

11 - linit non-existent 
Bit 13 - unit *rlte protected 
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Bit 12 - Unit at 80T (tape class only) 

Bit U - Unit at EOT (tape class only) 

Bit 10 - Other unit status problem (GET STATUS for detail) 

Bits 9-0 - Reserved 



4,S,7,5 Log Information format - 

Tne log Information is a counted ASCII string. 



4.5,7,6 Status Format - 

Bytes 12-13 - Same as summary status format 
Byte 14 - 

Bit - write protected by program 
Bit 1 - write protected physically 
Bit 2 - pack spin down / tape unloading 
bytfc lb - Current tape aensity 

same as In tape characteristics oioOc 



4,5.7,7 Characteristics Format - 



4,5,7,7,1 Controller Characteristics Format - 



For each host? 
Byte 12 



Byte 13 



Byte 14 



- Error and log control 

Bit - Send logs for this host 

bit 1 - Send logs for all hosts 

Bit 2 • configuration change reporting enabled 

felt 3 - Psuedo-terroinal enabled 

- Thesnolds 

Bits 0-i - ECC threshold 

A value of indicates to use the serious level 

threshold of each unit. 
Bits 4-7 - Log threshold 

- Reserved 



Common to all nosts 

Conf Inuratlon 

byte 15 - Number of hosts 

Byte 16 - Number of disics 

Byte 1? - Number of tapes 

Byte 18-19 - .dumber of ouffers 
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byte 20-21 - Number of cache blocks 
Shadow' pairs 

Byte 22 - Shadow copy control 

Bit - Copy for first pair 

Bit 2 - Copy for second pair 

Bit 4 - Copy for third pair 

Bit 6 - Copy for fourth pair 
Byte 23 - Reserved 

Bytes 24-25 - First pair of units \ 
Bytes 26-27 - Second pair of units 1 low order 8 bits 
Bytes 28-29 - Third pair of units 1 of each unit 
Bytes 30-31 - Fourth pair of units / 

Bytes 32-33 - Reserved 

bytes 34-35 - Diagnostic control 



4,5,7,7,2 Dlsfc Characteristics Format - 

GpoB-etry parameters 

Bytes 12-15 - maximuro LBN 

bytes 16-19 - revector table LBN 

bytes 20-21 - trades/cylinder 

Bytes 22-23 - LBN/trackCs-r of soi specification) 

Bytes 24-25 - RBN/tractcCr of SDI specification) 

Byte 26 

Bit - Dual Ported unit 

Bit 1 - 512/576 indicator 

Bit 2 - Removable pacic 

Bit 3 - Reserved 

Bits 4-7 - Serious ECC threshold 

Byte 27 - Performance statistic 

Byte 28 - Unit plug number 

Bytes 29-30 - Unit serial number 

Byte 31 - Flaqs 

Bit - Compare on all reads 
Bit 1 - Compare on all writes 
Bits 2-7 - Reserved 

Bytes 32-35 Dlaanostic control 
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I 

4,5,7,7.3 Tape Cnaracterlstics Format - 

I Bytes 12-23 - Reserved 

Byte 24 - Possible density settinas 
I Bit - 556 npi 

Bit 1 - 800 bpi 

Bit 2 - 1600 bpi 
I bit 3 - 6250 bpi 

Bits 4-7 - Reserved 

( Byte 25 - Reserved 

Byte 26 
1 fait - Dual ported unit 

Bits 1-7 - Reserved 

! Byte 27 - Performance statistic 

Byte 28 - Unit plug number 

Bytes 29-30 - Unit serial number 

' Byte U - Flaos 

Bit - Compare on all reads 
Bit 1 - Compare on all writes 
Bits 2-7 - Reserved 

Bytes 32-35 Diagnostic control 



4,5,7,8 Device and Unit Numbers - 

DV.MSC = 00 (controller) 
DV,DSK = 01 (disk class device) 
OV.TAP = 02 (tape class device) 

UN,CTR = OOFF (controller) 

UN.PST = ooFE (psuedo-terminal, dv.cTR) 
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4.5.7,9 Priority - 

PR.NRM = 
PR. HI = 1 



